This Help document describes new features that have been added since versions 2.1. The new manuals reflect these changes, but this document will allow long-time users to quickly get a flavor of what is new. Many of the new features discussed here are a direct result of requests from our users. We feel that continued software support utilizing feedback from our users is a very important part of our software products.
}
{-
}
{KaleidaGraph 3.0.4
July, 1994
New features added since the release of 3.0
}
{ Power Mac Support
KaleidaGraph now runs native on the Power Macintosh.
}
{ AppleScript
KaleidaGraph can now be controled with AppleScript.
These are common events:
Run: Run the application.
Open: Open documents
Print: Print documents
Quit: Quit the application.
These are KaleidaGraph private events:
Ready: Check to see if KaleidaGraph running.
Rebuild: Rebuild the plot to the current selection.
AppendColumn: Append one or more columns of data to the current data window.
AppendRow: Append one or more rows of data to the current data window.
Close: Close a window.
CloseFrontWindow: Close the front window without saving.
CloseAllWindows: Close all visible windows without saving.
LoadPlotScript: Load in a plot script file.
RunPlotScript: Execute a plot script.
GetData: Set the selection and get the data.
SendData: Send data to KaleidaGraph.
SetSelection: Set the selection in the frontmost data window.
RunTextScript: Execute a text script
ExportPlot: Export a plot.
PlotPrint: Print one or more plots.
OpenDatafile: Open a datafile.
SetRefDirectory: Set the Reference Directory.
GetWindowName: Get the name of one or more windows.
SelectWindow: Select a window.
}
{ SuperATM
KaleidaGraph is now compatible with SuperATM and SuitCase II. Font names will be added to the font menu whenever a new font is added to the system by either of these applications.
}
{ PowerBooks
KaleidaGraph will take advantage of the power manager on machines where it is available, to prevent the machine from switching into idle mode during long calculations or curve fits.
}
{ Scripts & AppleEvents
Several new commands have been added to the formula script and the tscp appleevent. These include:
The #PLOT_PRINT command and #PAGE_PRINT commands have been added to scripts. These commands allow the user to print the frontmost plot(s).
The #PASTE command has been added to scripts. It allow the user to paste the contents of the clipboard to a specified selection in the frontmost data window. The syntax is the same as #COPY.
A new command has been added to the #SCRIPT syntax that allows the user to set the axis titles via a script or appleevent.
For example:
#SCRIPT
plot_type = scatter
x axis limits 5.0 10.2
x axis title "This is a new title"
y axis limits 1 20
y axis title "This is a new Y axis title"
begin_group
x 0
y 1
end_group
#END
Also, if the axis limits in a script are enclosed in quotes they will be checked to see if the limits are numbers or dates.
}
{ Curve Fit Speed
The calculator speed has been improved approximately 25% in this version. As a result general curve fits and calculator programs will execute faster. General curve fits will execute up to 20% faster than before.
}
{ Text Import
The bullet "•" is now accepted as a missing cell during data import.
}
{ Number Format
A new option has been added to the Text Options dialog to allow users to select either comma or "." as the decimal delimiter for plot labels.
Also, in countries where the comma is the default decimal delimiter, KaleidaGraph 3.0.2 will require that numbers in formulas (formula window, library, general curve fit equations) must be in US format.
}
{-
}
{KaleidaGraph 3.0
April, 1993
}
{ System 7
Fairly extensive support has been added for System 7 to the latest version of KaleidaGraph. These features include Publish, Subscribe and Apple Events. An extensive set of private apple events has been added to KaleidaGraph in addition to the basic apple event support required by System 7.
KaleidaGraph Help has been moved to the Help menu on System 7 machines.
}
{Shortcuts
}
{ Exiting Dialogs
Enter and Return are mapped to OK.
Escape and Cmd-Period are mapped to Cancel in any dialog that has a Cancel button.
}
{ Closing Windows
The Shift key will now cause all windows to be closed with out saving. This will work whether the user clicks in the window close box or selects close from the File Menu.
}
{ Curve Fits
Cmd-A will now select all variables in a curve fit dialog.
}
{Data Windows
}
{ Data Formats
The data formats that KaleidaGraph understands have extended to include Double, Float, Integer, Date, Time, Text. Also the Date and Time formats have been modified to extend the range of dates/times available and allow more display formats.
KaleidaGraph now allows the user to choose whether the decimal separator will be a decimal point or a comma. Also the user may optionally choose to display a thousands separator.
Float:
Up to 7 significant digits resolution. Data may be displayed as General, Fixed, Scientific or Engineering (power of 3).
Double:
Up to 15 significant digits resolution. Data may be displayed as General, Fixed, Scientific or Engineering (power of 3).
Integers:
Up to 9 significant digits of resolution.
Date:
Absolute dates are stored in the Apple standard format (seconds since Jan. 1, 1904) with 9 significant digits of resolution. Dates may be displayed as:
month/d/y
m/d/y
d-month-y
d-m-y
month/d/y H:M:S
m/d/y H:M:S
d-month-y H:M:S
d-m-y H:M:S
Time:
Relative time numbers are stored as seconds.seconds with 15 significant digits of resolution. Relative time numbers may be displayed as:
Days: Hours: Minutes: Seconds.seconds
Hours: Minutes: Seconds.seconds
Minutes: Seconds.seconds
Seconds.seconds
Text:
Text strings of up to 21 characters in length may be stored in data cells.
}
{ Data Entry
When the user manually types numbers into the data windows, it will now be scanned for illegal characters or combinations. If these are found the data will be adjusted and a BEEP will sound to warn the user.
}
{ Moving Around
Several new functions have been added to the data window interface. SHIFT-TAB will now move the current cell to the left (where TAB moves right). SHIFT-RETURN will move the current cell up. Also clicking on the row number will always select the entire row.
{ Excel Worksheets
KaleidaGraph can now directly import Excel worksheets.
}
{ Column Format
The column format dialog has been redesigned to allow the user to select and modify the attributes of a range of columns at once.
}
{ Replotting
An icon has been added to the upper right corner of the data window to force an immediate recreation of the current plot from the data window. This options is useful if the user has modified the data in the window, but does not have auto refresh on. Alternately, the user may wish to make a number of changes to the data before forcing a single plot update.
}
{ Subscribe
The user may subscribe in the data windows to any edition containing text. The text in the edition is assumed to be tab separated columns. Data in the edition will be placed in the data window with the current cell anchoring the upper left corner.
}
{ Publish
The user may publish any selection from a data window. The data in the edition will be tab separated text.
}
{ Importing
Several new features were added to the text import facility.
A command was added to read streaming data.
For example: the data format X Y Y X Y Y X Y Y return
A command was added to set the column delimiter in special mode to be something other than white space.
Added a repeat mechanism to special format syntax.
For example: v 2(F12 3(a v))
where the syntax N( pattern ) will repeat the pattern enclosed in the parenthesis N times.
Added support for the D(d) exponential format number. The number x.xxDxx will be assumed to be a DOUBLE precision number.
}
{ Multiple Text Files
When the user opens multiple text files from the desktop under System 7, the Text Import Dialog will only be displayed for the first file. All others will be assumed to have the same format.
}
{ Create Series
When "Final Value" is checked in the Create Series dialog, KaleidaGraph will now add rows to the data window as is necessary to reach the final value specified.
}
{ Sorting
Up to 3 levels of sort "keys" can now be defined in KaleidaGraph. Each key can be individually set to ascending or descending sort.
}
{ Transpose
The Transpose function will now only transpose the current selection in the data window instead of the square matrix implied by the largest dimension of the selection.
}
{Plot Script
The plot script will now track the windows that X & Y variables are selected from and reproduce them as faithfully as is possible when the script is loaded and executed. This will now allow the user to create new kinds of scripts.
Added "\r" as a new special code for text labels. "\r" will insert a <return> into the label. This is particularly useful for embedding returns in column titles and script plot legends and titles.
For Example:
Several X & Y sets can be selected from the same data window.
Each Plot could have X & Y data sets selected from sequential data windows.
Each Plot could have X & Y data sets selected from different data windows.
}
{Plot Window
The plot window user interface has been completely replaced with an interface that is much more similar to a drawing program such as MacDraw™ or Canvas™.
}
{ Tool Palette
The plot window has a new tool palette. This palette may be moved anywhere in the plot window or closed to put it out of the way. The tool palette includes the following tools:
Arrow
Text
Lines and Arrows
Box
Oval
Round-Cornered Boxes
Arc
Polygon
Bezier Curves
Tables
Eraser
Identify
Align Objects
Data Selection
Zoom & Pan
Note: as different parts of the plot are selected, the lower portion of the tool palette will change to suit the object selected. This will happen for variable markers, the plot frame and the individual plot axes (X, Y, X2, Y2).
}
{ Arrow
The arrow can now be used to select multiple objects at one time. "Click" on a single object to select it or "Shift Click" to add or subtract additional objects. Double click on an object to edit that object (if it is possible). Text, arrow heads, polygons, bezier curves, tables, and axes can all be edited by double clicking on the object.
Dragging with the mouse will select all objects completely enclosed within the marquee.
Note: "Shift Dragging" will add or subtract objects from the current selection.
If the Command Key is depressed when the mouse is clicked, the arrow will switch to the most recently used tool. For example, if the last tool used was the box tool, then if the Command key is used together with the mouse, it will switch to the box tool automatically.
Note: The option key can no longer be used with the mouse to edit grouped text objects such as axis labels or legend labels. Instead, the text tool should be used. The text tool will always reach through any grouping to edit an individual text item.
}
{ Text
Select, create, and modify text objects. To create a text object, click with the mouse on any empty section of the plot window. Double click on the object to edit it.
Notice that the text tool has a small symbol on the right side. This means that there is a menu attached to the tool. Click on the tool and hold the mouse down and a menu will pop up to allow you to modify the attributes of any selected text object. Font, Size, Style, Rotation, Alignment and Background can all be modified. Try selecting a group of labels and changing their fonts all at once.
Note: The text tool will always reach through any grouping to edit an individual text item.
Also, only the menus attached to the text tool, or in the text edit dialog will modify the attributes of a text object.
}
{ Line/Arrow
Create and modify lines and arrows with this tool. There are 11 different type of lines that the user can select from. (The 12th item is reverse) Click and drag with this tool to create a line or arrow. If the Shift key is depressed while creating the line, it angle will be limited to 45° increments.
Arrow heads may be edited by double clicking on the arrow (with the arrow tool selected).
Notice that the Line tool has a small symbol on the right side. This means that there is a menu attached to the tool. Click on the tool and hold the mouse down and a menu will pop up to allow you to modify the type of any selected line/arrow object. Try selecting a group of lines and changing their type all at once.
Lines can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Line Style (dash pattern)
Pen Thickness
Double Line
}
{ Box
Create a box object.
Boxes can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Line Style (dash pattern)
Pen Thickness
Shadow
Double Line
}
{ Round Cornered Box
Create a Round Cornered Box object.
Round Cornered Boxes can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Pen Thickness
Shadow
Double Line
}
{ Oval
Create a oval object.
Ovals can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Pen Thickness
Double Line
}
{ Arc
Create a arc object.
Arcs can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Pen Thickness
Double Line
}
{ Polygon
Create a polygon by clicking with the mouse to define the polygon vertices. Double click on a polygon (with the arrow tool) to edit an existing polygon.
Polygons can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Line Style (dash pattern)
Pen Thickness
Double Line
}
{ Bezier curves
Create a bezier curve by clicking with the mouse to define the curve vertices. Drag with the mouse at a vertex to define the arch of the curve at a vertex. Double click on a curve (with the arrow tool) to edit an existing bezier curve.
Bezier curves can have the following attributes:
Foreground Color
Background Color
Pen Pattern
Fill Pattern
Line Style (dash pattern)
Pen Thickness
Double Line
}
{ Align
Align a group of selected objects by either the left side, right side, top, bottom, horizontal center or vertical center.
}
{ Data Selection
The Data Selection tool allows the user to select the data they wish to view by enclosing them in a polygon. If the OPTION key is depressed when using the tool, the enclosed data will be removed from the display.
}
{ Color
Set the foreground or background color of any object, plot variable, axis or grid.
}
{ Pattern
Set the fill pattern of any object or variable.
}
{ Line Style
Set the line pattern (dash, dot dash, etc.) of any object or variable to one of 11 dash patterns.
}
{ Pen Thickness
Set the pen thickness of any object or variable to one of 10 thicknesses, Shadow or Double.
}
{ Resizing Objects
Objects can be resized by selecting one of the four boxes that appear when the object is selected. If the SHIFT key is depressed while resizing the object, it will be forced to be square. If the OPTION key is depressed when the corner is selected for resizing, the object will be resized uniformly about its center.
If the SHIFT and OPTION keys are both depressed the object can be resized at a constant aspect ratio.
}
{ Moving Objects
Selected objects can be moved by dragging any one of the selected group with the mouse. Also the Arrow Keys can be used to nudge the objects one pixel at a time. (SHIFT Arrow moves the objects 10 pixels at a time)
}
{ Cut/Copy/Paste
Cut, Copy, Paste, Clear from the Edit Menu can now be used to cut/copy selected objects to clipboard and paste them into a plot. Clear will delete all selected objects (as will the Delete Key).
}
{ Duplicate
Duplicate the selected objects and move the slightly down and to the right.
}
{ Undo
Undo will now undo the last operation that occurred in a plot window as well as the last operation in any data window. Undo will be reset by any plot rebuilds.
}
{ New Colors
KaleidaGraph now supports a editable palette of 64 colors that can be selected for use with any object. Each cell in the palette can be edited to change its color selection (See Edit Colors in the Object Menu).
{ Plot Size
The physical plot page is now allowed to be larger than the plot window. The user can grab the lower right corner of the plot and resize it independently of the window. Scroll bars allow the user to move around and view different portions of the plot if it is larger than the window.
The plot size can also be set numerically via the "Plot Size" command in the Plot Menu. Here, the user can independently set the plot frame, axis size and axis offset values.
}
{ Plot Window Scaling
A pop up menu in the lower left corner of the plot window allows the plot scaling to be set to one of 8 values from 25% to 400%.
}
{ Define Layout
The plot layout now remembers the positions of the axis titles in addition to the plot size & position, legend size & position, visible legends.
}
{ Subscribe
Plot windows can subscribe to any number of editions containing PICT format data.
The subscribed PICT can be moved, resized and its attributes modified the same as a PICT that was pasted in from the clipboard.
}
{ Publish
Each plot can have 1 publisher. The entire plot window will be published to the edition file. Plots can be published with the same options that apply to copying to the clipboard.
}
{ Import EPS Files
EPS files can now be imported into KaleidaGraph much the same as PICT's have been in the past. The imported picture can be moved, resized and boxed with the same attributes as a picture.
}
{ Variable Selection
The plot Gallery dialog has been enhanced to now remember the order in which variables are selected for plotting. This will allow the user to easily set the order that variables will appear in the plot legend and in column plots.
}
{ Axis Options
The axis options dialog has been redesigned for easier use and more features. For each axis X, Y, X2, Y2 the axis options dialog has 4 major sections Limits, Ticks, Grids, and Labels. Each section will display the current settings with a small picture.
}
{ No Axis option
Each axis has the option of turn off all tick and frame drawing. Grids are controlled separately.
}
{ Setting Min & Max
The Min and Max limits for all axes can now be independently set to auto scale or fixed limits.
}
{ Axis Limits & Labels
Each axis can now have an anchor tick defined for its ticks & labels. All tick positions will be calculated off this anchor value. For example, the default anchor is 0. If the axis limits were 4.8 to 10.2, ticks and labels will be placed at 5.0, 6.0, 7.0, 8.0, 9.0 and 10.0.
}
{ Tick Interval
In addition to Auto and Fixed # of ticks, the user can now directly specify the tick interval for major ticks. As a shortcut, if a number with a decimal point is typed into the major tick edit field, the major tick type will automatically switch to Interval.
}
{ Solid Grids
Grids can now be either gray or solid. This can be controlled individually for major and minor grids.
}
{ Grid thickness
Grid thickness can now be controlled in the same fashion as Ticks and the plot frame. Grid thickness can be scaled from 100% up.
}
{ Tick Labels
In addition to Auto and Every Nth, the number of labels can now be set to be None. In this case NO labels will be generated.
Also for LOG axes, if there are less than 2 major tick labels shown, the minor ticks will automatically be labeled. So, zoomed-in plots can get minor tick labels now.
}
{ Label Formats
The tick label formats have been expanded to match the new data formats in the data window including Engineering as a display format. "Display Commas" as the thousands separator is now an option in label format.
Note: When working with Dates, the number of digits selected will control whether the Date is displayed as Month, Month/day or Month/day/year.
}
{ Linking Text
An option has been added to the Text Options dialog (Format Menu) "Link Text to Variable Color". By default this is checked. If this option is unchecked, then Legend Text, regression text, error bar text, and value text is no longer linked to the variable color. Also, value labels and error bar text have been modified to remember alterations to Color, Font, Style, Size and Erase on a label by label basis.
}
{ Axis Linking
The X2 and Y2 axes can now be linked to the primary axis (either X or Y) under user control. The users can select:
No Ticks, No Labels
Axis, No Labels
Axis, Labels
Custom Axis, Custom Labels
For Custom Axis the axis is linked to the primary axis by a user specified formula. Either a + b*x or a * x^2. Thus the limits of the linked axis will be calculated from the primary axis limits via the user formula. Other than the axis scaling and reverse setting, the linked axis can be completely customized with unique tick, grid and label settings.
}
{ Markers & Line Styles
2 new markers, patterns, line patterns and thicknesses have been added.
}
{ Show Markers
Show Markers has been enhanced to allow the user to select from displaying a Fixed # of data points (2, 3, 4, 5, 10, etc.), a % of the data (1%, 2%, 5%, 20%, etc.) or Every Nth point (2, 3, 4, 5, 10, etc.).
}
{ Error Bars
Error bars can now have independent upper and lower error specifications. The types of error selections now include a # of Standard Deviations from the mean. An additional option has been added to allow the user to display only the error bar cap.
Also if a text label is selected as the error bar, it can now be automatically centered on the data point as well as left justified and rotated.
}
{ Error Arcs
Error bars can now define error ellipses about the data point. Each quadrant of the error ellipse can be independently defined.
}
{ Curve Fit Labels
The display format of all regression labels can now be specified by the user.
}
{ X2 Axis Labels
The display format of X2 axis labels can be controlled the same as X, Y and Y2.
}
{ Curve Fit Options
The Curve fit options have been placed in their own dialog in the format menu.
Also curve fits can now (optionally) be extrapolated to the axis limits.
}
{ Histogram Options
Histograms can now have the number of bins either be automatically calculated or specified in the Histogram Options dialog in the format menu. Also, the number of ticks on the histogram X axis no longer has to be the same as the number of bins.
Also, the Y axis title has been changed to "Count"
}
{ Probability Plots
Probability plots will now included all data selected for a variable in the calculated probability distribution, not just the data that falls within the current Y axis limits.
}
{ Polar Plot Options
Polar plots have had some significant enhancements in this release.
The minimum value of a polar plot no longer has to be zero. It can now be any value.
The direction and reference angle for the angular scale THETA can now be specified by the user.
While the radial axis is still controlled by the Y axis settings, the angular axis settings are now controlled by the X axis settings.
Angular labels are now placed around the circumference of the polar plot.
The radial axis scaling can now be LOG as well as LINEAR.
}
{ Column/Bar Plots
The X axis title has been changed for Column and Bar plots from Category to whatever the X axis "Variable Name" is.
Column and Bar plots have been modified to clip to the axes of the plot for exported pictures.
}
{ Column/Bar Ticks
The number of X axis ticks no longer has to be the same as the number of categories. So, if your plot has 200 categories you can choose to have only a few ticks shown.
}
{ Log Column Plots
Column plots can now have log scales on the Y axis.
}
{ Template Plots
Template plots will now new plots instead of replotting into the current window. Also, Template Plots now will honor error bar and curve fit selections.
}
{ Update Plot Now
The "Update Plot" command has been added to the plot menu. When selected it will force an immediate regeneration of the plot from the original data.
}
{ Find Data Icon
An Icon has been added to the upper right corner of the plot window. When the user clicks on this icon if will find any data windows referenced by this plot an bring them to the front immediately. If the data windows are archived, the windows will be extracted and displayed.
}
{ Printing
Text imaging has been substantially improved in printing. Text that is not a built-in font in your printer will now be imaged at the maximum resolution your printer allows. This results in much smoother text (no more jaggies). Also, you will find that rotated text will print at the same quality as non-rotated text. Users who are not using postscript printers will particularly notice the improvement. The length control for strings has been improved in 3.0 also.
}
{ Show Page
An option called "Fast Refresh" has been added to the Show Page. If fast refresh is checked, only the frame of the plot will be drawn allowing the user to quickly adjust plot positions and sizes.
}
{ Tables
A new feature called Copy Style has been added to the edit menu in the table tool. This command allows you to copy the formatting information or "Style" of a selection of cells without copying the data in those cells. Then for formatting information can be pasted over another area of the table. This provides a quick way to replicate the format information of a group of cells.
}
{Object Menu
}
{ Align
Align a group of selected objects by either the left side, right side, top, bottom, horizontal center or vertical center.
}
{ Up
Move the selected objects one level to the front.
}
{ Bring to Front
Move the selected objects to the front of all other objects.
}
{ Down
Move the selected objects down one level to the back.
}
{ Send to Back
Move the selected objects to the back of all other objects.
}
{ Group
Group the currently selected objects into a single object.
}
{ Ungroup
Ungroup the any selected groups into individual objects.
}
{ Edit Object
Edit the selected object. If more than one object is selected, the front most will be edited.
The following objects can be edited:
Text
Arrows
Polygons
Bezier Curves
Tables
Plot Axes
}
{ Edit Colors
Edit the color palette for this plot window.
}
{ Edit Arrow Heads
Edit the default arrow heads.
}
{Curve Fits
}
{ 16 General Fits
You can now define up to 16 general curve fit equations for use at one time. The General item in the Curve Fit Menu has become a new menu. The first item is command Edit General. This displays a dialog where you can create new curve fits, edit old fit definitions, or simply reorder or delete old definitions.
The General Curve Fit Definitions are saved in the KG Macros file and also in plot files.
}
{ Curve Fit Errors
The way errors are calculated for General fits has been improved for the case where the user supplies weights.
}
{ Display R^2
An option has been added to the Curve Fit Options dialog to allow the user to select whether R or R^2 will be displayed.
}
{Formula Entry
The formula entry window now has a series of menus that allow the user to select from the operators, functions, curve fits, statistics and library functions available and use them in the formula.
option - "p" will now be recognized as the π symbol in formulas.
}
{ Column Variables
Formulas can now address the entire data window directly with column variables.
For example:
c255 = -pi/2 + pi * index()/128
}
{ New Functions
There are a number of new formula entry functions and operators available.
New Functions:
cell(row #, column #) Get or set the value in a specific cell.
rsum(column variable) Compute the running sum of a column.
norm(#) Compute the normal distribution value of a number between 0 and 100 %.
inorm(#) Compute the inverse of the normal distribution.
New Statistics functions
cmin()
cmax()
mean()
median()
npts()
csum()
var()
std()
stderr()
rms()
skew()
kurtosis()
Each of these functions can be used in two ways. The simplest is to use it with a column variable. For example:
c1 = (cmax(c0) - cmin(c0))/npts(c0)
c1 = median(c0)
These functions can also be used with a new operator, the matrix operator []. This operator allows you to define a range of rows and columns (around the current row index) to use for the computation. The syntax is:
[2 : 10, 0 : 1] rows 2 through 10 in columns 0 through 1
Example: Find the median value of all data in columns 2 & 3
median([ , 2 : 3])
Example: Find the standard deviation of a window of data from -10 rows to +10 rows around the current row in column 0.
c2 = std([-10:10, 0 : 0])
Formula Curve Fits:
The gen() function has a new (and optional) argument. The new syntax is:
gen("fit name", x value, column variable of fit)
or
gen(x value, column variable of fit)
If no name is supplied, then the first general fit that is found in that column will be used.
Special:
The macro command allows the user to execute a macro by name.
macro("Integrate")
}
{ New Commands
The formula posted note can now support the same text script language that KaleidaGraph supports via apple events. This will allow users to build scripts in KaleidaGraph and use them at a latter time (or test them for use from apple events).
Note: Commands that require options or more information are terminated by #END at the beginning of the line. See the file on Apple Events & Formula Scripts for more detailed syntax information.
#FORMULA
standard formula code..... i.e.: c0 = index();
#END
#DATA
Place the enclosed data in a new window with titles.
#END
#DATA/NOTITLE
Place the enclosed data in a new window without titles.
#END
#CLOSE (Close the front most visible window without saving.)
#CLOSE/ALL (Close all visible windows without saving.)
#DATAFILE
Read in a data file by name.
#END
#SCRIPT
Define and run a Plot Script.
#END
#SELECTION
Set the selection in the data window.
#END
#COPY
Copy the selected data to the clipboard.
#END
#PICT
Copy the topmost plot window to the clipboard.
#PICT/OPT
Copy the topmost plot window to the clipboard with options.
#END
#SET_DIRECTORY
Set the default directory for opening data files and plots.
#END
NOTE: BY DEFAULT the contents of a formula script are treated as formula commands UNLESS one of the commands described above is used to change its meaning.
}
{Calculator Changes
The macro calculator has a new (and improved) face plate as well as improvements in the debug/trace modes. New are a number of new calculator commands (see next list).
Also, constants are now double precision by default! You no longer need to use the "const" command before typing in your number (i.e. just type the number). To get an old style single precision constant type "const" before the number as before.
Also, all vector commands can now address up to 255 columns in a data window. For example: Rclv 200, Stov 255.
The calculator can now read and write strings from the data window. Text recalled from a window will be saved to the ALPHA register and text stored to a window will be written from the ALPHA register. NOTE: executing a RCL (recall) operation on a cell containing text will NOT alter the stack.
}
{ version
Return the current KaleidaGraph version number. The version # times 100 will be stored in the X register of the stack. For example, version 3.00 will be stored as 300.
}
{ ibase
The ibase command (for Indirect addressing Base) will change the column addressing base used in all indirect addressing commands that access the data window.
Old Method:
125.12 row 125, column 12
New Method:
125.012 row 125, column 12
130.255 row 130, column 255
Remember the old addressing method is used by default unless the ibase command is included in the program. (Note: if the ibase command appears ANYWHERE in the program, the entire program will use the new addressing method. Your cannot switch back and forth between the old and new methods.)
}
{ rsum 00
Compute the running sum of column #00
}
{ genf 00
Get the general curve fit data in column #00 using the name stored in the alpha register.
{ statistics
Commands:
cmin
cmax
csum
npts
mean
median
rms
std
var
stderr
skew
kurtosis
These commands all have the same syntax. The addresses for these commands is stored in the bottom 4 locations of the stack. S(0) to S(3).
S(0) = ending column (or offset)
S(1) = starting column (or offset)
S(2) = ending row (or offset)
S(3) = starting row (or offset)
All 4 addresses will be removed from the stack and the result of the function will be pushed back on.
}
{ getcell
Get the value of a cell at a specific row and column address. The column address is located at the bottom of the stack S(0) and the row address is located at S(1). The both addresses are removed from the stack and the cell value is pushed onto the stack.
}
{ setcell
Set the value of a cell at a specific row and column address. The value to be saved is located at the bottom of the stack S(0). The column address is located at S(1) and the row address is located at S(2). The addresses will be removed from the stack leaving the S(0) undisturbed.
}
{Apple Events
A number of new apple events have been added to KaleidaGraph in addition to the required set of apple events for opening files, printing, and publish/subscribe.
}
{ redy
Cmd Direct Object Optional Return
redy none none none
This apple event just checks to see if KaleidaGraph is running.
}
{ cfns
Cmd Direct Object Optional Return
cfns none none none
Close the front most visible window without saving its contents.
}
{ call
Cmd Direct Object Optional Return
call none none none
Close all visible windows without saving their contents.
}
{ epic
Cmd Direct Object Optional Return
epic TEXT FILE PICT (opt)
This command has several forms and both the parameters are optional. If no parameters are supplied, the front most plot is returned as a PICT. The direct object is text and sets the scale factor, postscript_pict, hires_pict and file parameters. The optional FILE parameter is of typeFSS or typeAlias and allows the PICT to be saved to a file. NOTE: the PICT is returned only if a file is not specified.
}
{ kdoc
Cmd Direct Object Optional Return
kdoc TEXT FILE none
Load in the data file described in either the direct object or the FILE object. If the data file is text, use the information in the direct object (or the current text file definition) to read it. The optional FILE object is of typeFSS or typeAlias.
}
{ kgqt
Cmd Direct Object Optional Return
kgqt none none none
Quit KaleidaGraph as soon as is possible.
}
{ ldat
Cmd Direct Object Optional Return
ldat TEXT none none
Load the data in the direct object into a new data window. The data is assumed to be tab separated with titles in the first row.
}
{ ldnt
Cmd Direct Object Optional Return
ldnt TEXT none none
Load the data in the direct object into a new data window. The data is assumed to begin in the first row.
}
{ ldap
Cmd Direct Object Optional Return
ldap TEXT none none
Append the data in the direct object to the front most data window. The data is assumed to begin in the first row.
}
{ lscp
Cmd Direct Object Optional Return
lscp TEXT FILE none
Load the plot script specified in either the direct object or the FILE object. This file should be in the plot script folder or specified by a fully qualified path. The optional FILE object is of typeFSS or typeAlias.
}
{ rplt
Cmd Direct Object Optional Return
rplt none none none
Replot the active plot using the selection current data selection.
}
{ rscp
Cmd Direct Object Optional Return
rscp none none none
Run the plot script.
}
{ tscp
Cmd Direct Object Optional Return
tscp TEXT none none
Run the text script contained in the direct object.
}
{ ssel
Cmd Direct Object Optional Return
ssel TEXT none none
Set the data selection to match the range contained in the direct object.
}
{ gsel
Cmd Direct Object Optional Return
gsel TEXT none TEXT
Set the selection to match the range in the direct object and return any data in that range.
}
{ refd
Cmd Direct Object Optional Return
refd TEXT or typeFSS none none
Set the reference directory to be the directory specified in the direct object. The direct object may be of type TEXT, typeFSS or typeAlias. If it is of type TEXT, the object should contain a simple text string describing either a full or partial path to the new directory. The reference directory is used as the base directory for all simple file names and partial path names except for those describing script files. Script files have their own base directory. This command has no optional parameter.
